home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / afmtodit.1 < prev    next >
Text File  |  1995-07-25  |  10KB  |  199 lines

  1.  
  2.  
  3.  
  4.      AAAAFFFFMMMMTTTTOOOODDDDIIIITTTT((((1111))))    GGGGrrrrooooffffffff VVVVeeeerrrrssssiiiioooonnnn 1111....00009999 ((((00004444 MMMMaaaarrrrcccchhhh 1111999999994444))))     AAAAFFFFMMMMTTTTOOOODDDDIIIITTTT((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           afmtodit - create font files for use with groff -Tps
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           aaaaffffmmmmttttooooddddiiiitttt [ ----nnnnssss ] [ ----dddd_d_e_s_c__f_i_l_e ] [ ----eeee_e_n_c__f_i_l_e ] [ ----iiii_n ] [
  13.           ----aaaa_n ] _a_f_m__f_i_l_e _m_a_p__f_i_l_e _f_o_n_t
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.           aaaaffffmmmmttttooooddddiiiitttt creates a font file for use with groff and ggggrrrrooooppppssss.
  17.           aaaaffffmmmmttttooooddddiiiitttt is written in perl; you must have perl version 3
  18.           installed in order to run aaaaffffmmmmttttooooddddiiiitttt.  _a_f_m__f_i_l_e is the AFM
  19.           (Adobe Font Metric) file for the font.  _m_a_p__f_i_l_e is a file
  20.           that says which groff character names map onto each
  21.           PostScript character name; this file should contain a
  22.           sequence of lines of the form
  23.  
  24.                _p_s__c_h_a_r _g_r_o_f_f__c_h_a_r
  25.  
  26.           where _p_s__c_h_a_r is the PostScript name of the character and
  27.           _g_r_o_f_f__c_h_a_r is the groff name of the character (as used in
  28.           the groff font file.) The same _p_s__c_h_a_r can occur multiple
  29.           times in the file; each _g_r_o_f_f__c_h_a_r must occur at most once.
  30.           _f_o_n_t is the groff name of the font.  If a PostScript
  31.           character is in the encoding to be used for the font but is
  32.           not mentioned in _m_a_p__f_i_l_e then aaaaffffmmmmttttooooddddiiiitttt will put it in the
  33.           groff font file as an unnamed character, which can be
  34.           accessed by the \\\\NNNN escape sequence in ttttrrrrooooffffffff.  The groff font
  35.           file will be output to a file called _f_o_n_t.
  36.  
  37.           If there is a downloadable font file for the font, it may be
  38.           listed in the file ////uuuussssrrrr////sssskkkkuuuunnnnkkkk////lllliiiibbbb////ggggrrrrooooffffffff////ffffoooonnnntttt////ddddeeeevvvvppppssss////ddddoooowwwwnnnnllllooooaaaadddd;
  39.           see ggggrrrrooooppppssss(1).
  40.  
  41.           If the ----iiii option is used, aaaaffffmmmmttttooooddddiiiitttt will automatically
  42.           generate an italic correction, a left italic correction and
  43.           a subscript correction for each character (the significance
  44.           of these parameters is explained in ggggrrrrooooffffffff____ffffoooonnnntttt(5)); these
  45.           parameters may be specified for individual characters by
  46.           adding to the _a_f_m__f_i_l_e lines of the form:
  47.  
  48.                iiiittttaaaalllliiiiccccCCCCoooorrrrrrrreeeeccccttttiiiioooonnnn _p_s__c_h_a_r _n
  49.                lllleeeeffffttttIIIIttttaaaalllliiiiccccCCCCoooorrrrrrrreeeeccccttttiiiioooonnnn _p_s__c_h_a_r _n
  50.                ssssuuuubbbbssssccccrrrriiiippppttttCCCCoooorrrrrrrreeeeccccttttiiiioooonnnn _p_s__c_h_a_r _n
  51.  
  52.           where _p_s__c_h_a_r is the PostScript name of the character, and _n
  53.           is the desired value of the corresponding parameter in
  54.           thousandths of an em.  These parameters are normally needed
  55.           only for italic (or oblique) fonts.
  56.  
  57.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  58.           ----nnnn   Don't output a lllliiiiggggaaaattttuuuurrrreeeessss command for this font.  Use
  59.                this with constant-width fonts.
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 7/8/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      AAAAFFFFMMMMTTTTOOOODDDDIIIITTTT((((1111))))    GGGGrrrrooooffffffff VVVVeeeerrrrssssiiiioooonnnn 1111....00009999 ((((00004444 MMMMaaaarrrrcccchhhh 1111999999994444))))     AAAAFFFFMMMMTTTTOOOODDDDIIIITTTT((((1111))))
  71.  
  72.  
  73.  
  74.           ----ssss   The font is special.  The effect of this option is to
  75.                add the ssssppppeeeecccciiiiaaaallll command to the font file.
  76.  
  77.           ----dddd_d_e_s_c__f_i_l_e
  78.                The device description file is _d_e_s_c__f_i_l_e rather than
  79.                the default DDDDEEEESSSSCCCC.
  80.  
  81.           ----eeee_e_n_c__f_i_l_e
  82.                The PostScript font should be reencoded to use the
  83.                encoding described in enc_file.  The format of _e_n_c__f_i_l_e
  84.                is described in ggggrrrrooooppppssss(1).
  85.  
  86.           ----aaaa_n  Use _n as the slant parameter in the font file; this is
  87.                used by groff in the positioning of accents.  By
  88.                default aaaaffffmmmmttttooooddddiiiitttt uses the negative of the ItalicAngle
  89.                specified in the afm file; with true italic fonts it is
  90.                sometimes desirable to use a slant that is less than
  91.                this.  If you find that characters from an italic font
  92.                have accents placed too far to the right over them,
  93.                then use the ----aaaa option to give the font a smaller
  94.                slant.
  95.  
  96.           ----iiii_n  Generate an italic correction for each character so
  97.                that the character's width plus the character's italic
  98.                correction is equal to _n thousandths of an em plus the
  99.                amount by which the right edge of the character's
  100.                bounding is to the right of the character's origin.  If
  101.                this would result in a negative italic correction, use
  102.                a zero italic correction instead.
  103.  
  104.                Also generate a subscript correction equal to the
  105.                product of the tangent of the slant of the font and
  106.                four fifths of the x-height of the font.  If this would
  107.                result in a subscript correction greater than the
  108.                italic correction, use a subscript correction equal to
  109.                the italic correction instead.
  110.  
  111.                Also generate a left italic correction for each
  112.                character equal to _n thousandths of an em plus the
  113.                amount by which the left edge of the character's
  114.                bounding box is to the left of the character's origin.
  115.                The left italic correction may be negative.
  116.  
  117.                This option is normally needed only with italic (or
  118.                oblique) fonts.  The font files distributed with groff
  119.                were created using an option of ----iiii55550000 for italic fonts.
  120.  
  121.      FFFFIIIILLLLEEEESSSS
  122.           ////uuuussssrrrr////sssskkkkuuuunnnnkkkk////lllliiiibbbb////ggggrrrrooooffffffff////ffffoooonnnntttt////ddddeeeevvvvppppssss////DDDDEEEESSSSCCCC
  123.                Device description file.
  124.  
  125.           ////uuuussssrrrr////sssskkkkuuuunnnnkkkk////lllliiiibbbb////ggggrrrrooooffffffff////ffffoooonnnntttt////ddddeeeevvvvppppssss////_F
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 7/8/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      AAAAFFFFMMMMTTTTOOOODDDDIIIITTTT((((1111))))    GGGGrrrrooooffffffff VVVVeeeerrrrssssiiiioooonnnn 1111....00009999 ((((00004444 MMMMaaaarrrrcccchhhh 1111999999994444))))     AAAAFFFFMMMMTTTTOOOODDDDIIIITTTT((((1111))))
  137.  
  138.  
  139.  
  140.                Font description file for font _F.
  141.  
  142.           ////uuuussssrrrr////sssskkkkuuuunnnnkkkk////lllliiiibbbb////ggggrrrrooooffffffff////ffffoooonnnntttt////ddddeeeevvvvppppssss////ddddoooowwwwnnnnllllooooaaaadddd
  143.                List of downloadable fonts.
  144.  
  145.           ////uuuussssrrrr////sssskkkkuuuunnnnkkkk////lllliiiibbbb////ggggrrrrooooffffffff////ffffoooonnnntttt////ddddeeeevvvvppppssss////tttteeeexxxxtttt....eeeennnncccc
  146.                Encoding used for text fonts.
  147.  
  148.           ////uuuussssrrrr////sssskkkkuuuunnnnkkkk////lllliiiibbbb////ggggrrrrooooffffffff////ffffoooonnnntttt////ddddeeeevvvvppppssss////ggggeeeennnneeeerrrraaaatttteeee////tttteeeexxxxttttmmmmaaaapppp
  149.                Standard mapping.
  150.  
  151.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  152.           ggggrrrrooooffffffff(1), ggggrrrrooooppppssss(1), ggggrrrrooooffffffff____ffffoooonnnntttt(5), ppppeeeerrrrllll(1)
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 7/8/94)
  196.  
  197.  
  198.  
  199.